WHAT

• expose a minimal withLocalContext helper
• update the e2e init flow to call .withLocalContext when NAGA_LOCAL_CONTEXT_PATH (and optional name) are provided
• add createShivaClient to @lit-protocol/e2e so QA can control Shiva-managed testnets and assert epoch changes through a Lit client
• add full payment delegation life cycle e2e test
• fix maxPrice now is being sent as hex instead of decimal the node deserialises via serde_json into ethers::types::U256, which treats bare strings as hex. Sending our decimal bigint (e.g. "250000000000000000") therefore turns into the much larger 0x2500... amount.
• (❗️Note) This PR contains a minor changeset

Usage

import { createLitClient } from '@lit-protocol/lit-client';
import { nagaLocal } from '@lit-protocol/networks';
import { createShivaClient } from '@lit-protocol/e2e';

const network = nagaLocal.withLocalContext({
  networkContextPath: './lit-assets/blockchain/contracts/networkContext.json',
  networkName: 'naga-develop', // optional
});
const client = await createLitClient({ network });

const shiva = await createShivaClient(client, { baseUrl: 'http://localhost:8000' });
const before = await shiva.inspectEpoch();

// trigger epoch via Shiva and wait until the Lit client sees the rollover
await shiva.transitionEpochAndWait();

const after = await shiva.waitForEpochChange({ baselineEpoch: before.epoch });

Shiva APIs

• inspectEpoch() - snapshot the Lit client context (chain epoch, per-node epochs, threshold, connected count, latest blockhash).
• waitForEpochChange({ baselineEpoch, timeoutMs?, intervalMs? }) - poll until the epoch advances beyond the baseline (defaults: 60s timeout, 2s interval).
• transitionEpochAndWait() - trigger /test/action/transition/epoch/wait/<id> to advance the epoch and wait for completion.
• stopRandomNodeAndWait() - invoke /test/action/stop/random/wait/<id> to drop a random node and wait for the next epoch.
• pollTestnetState() - fetch /test/poll/testnet/<id> for the current Shiva state (Busy, Active, etc.).
• getTestnetInfo() - return /test/get/info/testnet/<id> payload (contracts, RPC URL, epoch config).
• deleteTestnet() - call /test/delete/testnet/<id> to shut down the managed testnet.
• baseUrl / testnetId – exposed properties for logging and reuse.

Snapshots published

🦋  New tag:  @lit-protocol/[email protected]
🦋  New tag:  @lit-protocol/[email protected]
🦋  New tag:  @lit-protocol/[email protected]
🦋  New tag:  @lit-protocol/[email protected]
🦋  New tag:  @lit-protocol/[email protected]
🦋  New tag:  @lit-protocol/[email protected]
🦋  New tag:  @lit-protocol/[email protected]
🦋  New tag:  @lit-protocol/[email protected]
🦋  New tag:  @lit-protocol/[email protected]

Test

Created a QA starter kit for this:
https://github.com/LIT-Protocol/QA-kit